acapoin 


7 AND 9-TRACK TAPE DRIVE SUBROUTINES IN ASSEMBLY LANGUAGE 

TDRIVE 1.3 
FEBRUARY 19, 1973 


Program 
Users Guido 




COPYRIGHT (c) 1973 BY DATAPOINT CORPORATION 



TORIVE User's Guide 


Datapoint Corporation 


August* 1973 



EXTERNAL DATA REFERENCES: 

INTERNAL DATA REFERENCES: LEN, RETRY, ERRMSG 


INTERNAL LABELS USED: TSRD$, TSRDl, TSWRTS, TSWRTI, TSWRT2, 

TRDATS, TRD$ TRD, TRD1, TRD2, RDPAR, 
RDENT, RDEOF, TCRD, TCRD1, DECBC, 

TWD$, WD, TERASE, TWRT$, TWRT, TWRT1, 
TWFMS, TCWRT, TDMP5, TDMP, TBKSFS, 
TBKSF , TBSF1, TBKSB$, TBKSB, TADVBS, 
TADVB, TADVFS, TADVF, TRWNDS, TRWND, 
TRWNDl , TADRS, TRDYS, TRDY, TPKT, 

ABORT 

CALLING PARAMETERS 


1 . 


General parameter passing packet format 


is: 


PACKET DA Length 
DA buffer 

To call a routine set the D & E register to the address of 
the parameter packet: 


DE PACKET 

CALL routine-name 

2. Read Routines: 


Numeric Read (TRDS) initiates a read and fills the specified 
memory buffer to the actual or specified length - whichever 
is shorter. Error conditions are as follows: 


True Sign Bad Parity (the routine retrys 3 times) 

True Carry End of File 

False Zero End of Tape Encountered 

String Read (TSRDS) expects the same parameters and reads as 
in the TRDS routine. The only difference is that an 015 is 
placed after the last data character. 

ggnUmmibh Re ad 1TRDATS) does not initiate a read, but 
continues transferring data from the hardware buffer to the 
memory buffer. False zero return indicates not in read 
mode. 

3. Write Routines: (Note: the system aborts the job if a 
write routine is called and there is no write ring.) 

Write/Dump 1TWDS) calls TWRT and TDMP. Attempts rewrite 
three times on parity error. 


String Write (TSWRTS) computes length to first 015 and jump 



to TWD$ 


Write Only (TWRTS) will transfer the specified number of 
characters from memory to the hardware buffer. The only 
error condition is true carry# indicating full buffer* 

Dump Only (TDMPS) dumps the hardware buffer to tape. Error 
conditions are true sign-parity error and true carry - end 
of tape encountered. 

4. Tape Movement Functions: 


TRWNDS 

Rewind 

TADVBS 

Advance Block 

TADVFS 

Advance File 

TBKSB$ 

Backspace Block 

TBKSFS 

Backspace File 

TWFMS 

Write File Mark 

TERASE 

Erase 3 inches of tape 


AVAILABLE ON CASSETTE: Yes, Source is included with MTOS 
system tape. 



